// 部分读懂
// On-disk file system format.
// Both the kernel and user programs use this header file.

#define ROOTINO 1  // root i-number 根设备号
#define BSIZE 512  // block size  每个块的大小为512字节

// Disk layout:
// [ boot block | super block | log | inode blocks |
//                                          free bit map | data blocks]
//
// mkfs computes the super block and builds an initial file system. The
// super block describes the disk layout:超级块
struct superblock {
  uint size;         // Size of file system image (blocks) 文件系统映像的大小，文件系统的所有块的大小
  uint nblocks;      // Number of data blocks
  uint ninodes;      // Number of inodes.
  uint nlog;         // Number of log blocks
  uint logstart;     // Block number of first log block
  uint inodestart;   // Block number of first inode block
  uint bmapstart;    // Block number of first free map block。 bit map区域第一个块
};

#define NDIRECT 12     // 直接快个数为12个
#define NINDIRECT (BSIZE / sizeof(uint))      // 间接块数
#define MAXFILE (NDIRECT + NINDIRECT)         // 最大快数，NINDIRECT是间接块数

// On-disk inode structure   磁盘上inode的结构
struct dinode {
  short type;           // File type `type` 域用来区分文件、目录和特殊文件的 i 节点。如果 `type` 是0的话就意味着这是一个空闲的 i 节点
  short major;          // Major device number (T_DEV only)
  short minor;          // Minor device number (T_DEV only)
  short nlink;          // Number of links to inode in file system `nlink` 域用来记录指向了这一个 i 节点的目录项，这是用于判断一个 i 节点是否应该被释放的
  uint size;            // Size of file (bytes) 记录了文件的字节数
  uint addrs[NDIRECT+1];   // Data block addresses 用于这个文件的数据块的块号
};

// Inodes per block.  每个块有多少个inodes
#define IPB           (BSIZE / sizeof(struct dinode))

// Block containing inode i     找到第i个inode所在的块
#define IBLOCK(i, sb)     ((i) / IPB + sb.inodestart)

// 一个扇区也就是512字节，而8位一个字节，所以一个BPB还是一个块
// Bitmap bits per block 位图块来管理磁盘中的块，每个块可以管理的大小为 BPB。位图，记录了哪些块能用，那些不能用。  每个块的位图位
#define BPB           (BSIZE*8)

// Block of free map containing bit for block b  包含块b位的自由映射块   找到b所在的位图块号，方便以后读取整块，读取判断
#define BBLOCK(b, sb) (b/BPB + sb.bmapstart)

// Directory is a file containing a sequence of dirent structures.  目录是一个包含一系列dirent结构的文件
#define DIRSIZ 14

// 文件或目录据结构，目录本身是以文件的方式存储到磁盘上的，叫做目录文件
struct dirent {
  ushort inum;            // i节点编号
  char name[DIRSIZ];      // 目录名最多为14字符
};

